3D Graphics Programming with QuickDraw 3D 1.5.4

Managing Interactive Renderers

QuickDraw 3D provides routines that you can use to manage interactive renderers.

Q3Renderer_IsInteractive

You can use the Q3Renderer_IsInteractive function to determine whether a renderer is interactive.



 
TQ3Boolean Q3Renderer_IsInteractive (TQ3RendererObject renderer);

renderer: A renderer.

DESCRIPTION

The Q3Renderer_IsInteractive function returns kQ3True if renderer is an interactive renderer and kQ3False otherwise.

Q3InteractiveRenderer_GetPreferences

You can use the Q3InteractiveRenderer_GetPreferences function to get the current preference settings of an interactive renderer.



 
TQ3Status Q3InteractiveRenderer_GetPreferences (

                     TQ3RendererObject renderer, 

                     long *vendorID, 

                     long *engineID);

renderer: An interactive renderer.
vendorID: On exit, the vendor ID currently associated with the interactive renderer. See "Vendor IDs" for the values that can be returned in this parameter.
engineID: On exit, the engine ID currently associated with the interactive renderer. See "Engine IDs" for the values that can be returned in this parameter.

DESCRIPTION

The Q3InteractiveRenderer_GetPreferences function returns, in the vendorID and engineID parameters, the vendor and engine IDs currently associated with the interactive renderer specified by the renderer parameter.

Q3InteractiveRenderer_SetPreferences

You can use the Q3InteractiveRenderer_SetPreferences function to set the preference settings of the interactive renderer.



 
TQ3Status Q3InteractiveRenderer_SetPreferences (

                     TQ3RendererObject renderer, 

                     long vendorID, 

                     long engineID);

renderer: An interactive renderer.
vendorID: A vendor ID. See "Vendor IDs" for the values you can pass in this parameter.
engineID: An engine ID. See "Engine IDs" for the values you can pass in this parameter.

DESCRIPTION

The Q3InteractiveRenderer_SetPreferences function sets the default vendor and engine to be used by the interactive renderer specified by the renderer parameter to the values passed in the vendorID and engineID parameters.

Q3InteractiveRenderer_GetCSGEquation

You can use the Q3InteractiveRenderer_GetCSGEquation function to get the CSG equation used by the interactive renderer.



 
TQ3Status Q3InteractiveRenderer_GetCSGEquation (

                     TQ3RendererObject renderer, 

                     TQ3CSGEquation *equation);

renderer: An interactive renderer.
equation: On exit, the CSG equation currently associated with the interactive renderer. See "CSG Equations" for the values that can be returned in this parameter.

DESCRIPTION

The Q3InteractiveRenderer_GetCSGEquation function returns, in the equation parameter, the CSG equation currently associated with the interactive renderer specified by the renderer parameter.

Q3InteractiveRenderer_SetCSGEquation

You can use the Q3InteractiveRenderer_SetCSGEquation function to set the CSG equation used by the interactive renderer.



 
TQ3Status Q3InteractiveRenderer_SetCSGEquation (

                     TQ3RendererObject renderer, 

                     TQ3CSGEquation equation);

renderer: An interactive renderer.
equation: A CSG equation. See "CSG Equations" for the values you can pass in this parameter.

DESCRIPTION

The Q3InteractiveRenderer_SetCSGEquation function sets the CSG equation to be used by the interactive renderer specified by the renderer parameter to the equation specified by the equation parameter.

Q3InteractiveRenderer_GetDoubleBufferBypass

You can use the Q3InteractiveRenderer_GetDoubleBufferBypass function to get the current double buffer bypass state of the interactive renderer.



 
TQ3Status Q3InteractiveRenderer_GetDoubleBufferBypass (

                     TQ3RendererObject renderer, 

                     TQ3Boolean *bypass);

renderer: An interactive renderer.
bypass: On exit, a Boolean value that indicates the current double buffer bypass state of the specified interactive renderer.

DESCRIPTION

The Q3InteractiveRenderer_GetDoubleBufferBypass function returns, in the bypass parameter, a Boolean value that indicates the current double buffer bypass state of the interactive renderer specified by the renderer parameter. If bypass is kQ3True , double buffering is currently being bypassed.

Q3InteractiveRenderer_SetDoubleBufferBypass

You can use the Q3InteractiveRenderer_SetDoubleBufferBypass function to set the double buffer bypass state of the interactive renderer.



 
TQ3Status Q3InteractiveRenderer_SetDoubleBufferBypass (

                     TQ3RendererObject renderer, 

                     TQ3Boolean bypass);

renderer: An interactive renderer.
bypass: A Boolean value that indicates the desired double buffer bypass state of the specified interactive renderer.

DESCRIPTION

The Q3InteractiveRenderer_SetDoubleBufferBypass function sets the state of double buffer bypassing for the interactive renderer specified by the renderer parameter to the Boolean value specified by the bypass parameter.